home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Belgian Amiga Club - ADF Collection
/
BS1 part 43.zip
/
HyperCat 1.30.adf
/
HyperCat1.30.doc
< prev
next >
Wrap
Text File
|
1988-07-13
|
8KB
|
166 lines
Hypercat 1.30 software/disk cataloger.
By Ian Wu. (C) Feb 1988.
The cataloger can be run from Workbench or from the CLI. It will open
a 2 colour screen using your Workbench's foreground/background colours.
Use the menus or keyboard shortcuts to select functions. Both PAL and
NTSC machines are supported (Pal owners get about 5 extra lines of info).
Note: For CLI users, if you have lots of directories to read,
you may need to use 'Stack 10000' before running HyperCat.
The cataloger's format consists of three fields:
1 - The program's name (max 30 chars)
2 - The program's type eg. Educational (max 20 chars)
3 - The disk number (1 - 9999)
A maximum of 5000 programs is allowed. (This may be increased if
a suitable donation accompanies the request, HINT, HINT).
On the title bar of the screen, you will see the current number of
records in the catalog, and also the current record range being displayed.
Project Menu
Open - Opens a catalog and merges (appends) it to the end of the current
catalog (if there's already one in memory). A file requester will
appear, and you may either:
1 - Type in the file name (and optionally the drawer and disk)
2 - Click on a file, then click OK
3 - Double click on the file
4 - Click the Cancel button to abort the selection
Save - Save the catalog under a name, you may select the name of the
file in the same way as when opening it.
New - Clear the catalog. You'll get a requester asking you
to confirm your request.
Quit - Quits the program what else?
Sort Menu
Name - Sorts the catalog in alphabetical order under program name.
Type - As above for the type field.
Disk Number - Ditto for disk numbers.
Find Menu
Name - Finds a particular program name or group of names. This is case
sensitive. Type in a name (or close to cancel). If it exists, it
will be displayed on the top line in highlight. Alternatively,
you may give a wild card specification as follows:
* - matches any number of characters
? - matches a single character
Eg. a*b - find programs starting with lower case 'a' and ending
with lower case 'b'
co? - find program names starting with 'co' with one
character after it (co1, cod co3, coo etc)
In this case, no name will be highlighted, but all matches if
any will be moved to the top of the screen (and the top of
the catalog, so you may have to re-sort the catalog).
Type - As above for program type.
Disk Number - As above for a range of disk numbers. You'll be asked
to enter the lowest and largest range of disk numbers to
search for (or click on close to cancel).
Eg. from 12 to 33 - search for programs with disk numbers
between 12 and 33 inclusive.
Repl. Type - Allows you to change the type of a program (by doing a
search and replace). You will be asked to enter the program
type you want to change, then the type you want it to be.
Then you will receive a requester asking for a global
replacement or not. If you choose OK! then all occurrences of
the first type you entered will be changed to the second type
automatically. If you choose CANCEL! then you will be prompted
to type Y (for yes) if you want to change the type, or N
(for no) if not. The appropriate record will be highlighted on
the top line to show the record HyperCat is looking at.
Delete Menu
Name - }
Type - } As above but delete any matches.
Disk Number - }
Insert Menu
Record - Click on cancel to cancel. Otherwise enter the program name,
type and disk number and click on ok. The program will be
inserted at the end of the catalog. If the displayed range
(see title bar) is not at the end, you won't see the
new record.
Disk - You will be asked to give the disk number and the
volume/drive name you want to read, or click on close to
cancel. The entire contents of the disk and all
directories/subdirectories will be read and program files
will be inserted into the catalog. The type field for each
of these programs will default to 'Command'. You can change
this later by editing the record(s).
You can also read starting from a specific directory by
giving the name of that directory, like 'DF1:MyDir/'
(Note that you must type the trailing slash). Hypercat will
start reading from that directory and all its subdirectories.
Exclude .info files - You can toggle this selection on and off. If
you select this (menu will have a tick next to it), all
files ending in '.info' will be ignored and not inserted.
This is the default mode.
Display Menu
Forward - Moves you forward a page at a time through the catalog.
A page is the maximum number of lines that can fit on the
screen (about 23 for PAL machines, 18 for NTSC).
Backward - Takes you backwards a page at a time.
Top - Goes to the top of the catalog.
Bottom - Goes to the bottom of the catalog.
Alternatively, you may use the up/down arrow keys to scroll
up or down the catalog one line at a time.
Print Menu
Name - Enter the range of records to print (defaults to all records),
or click close to cancel. For example from 2 to 6 prints just
records 2 to 6. You can use preferences to change to condense
mode printing (don't forget to set pitch and margins). In
this case, Hypercat will print in 3 columns.
You can press the SPACE bar to stop the printing.
Name/Disk Number - As above, but prints name and disk number.
Name/Type/Disk Number - As above but a single record per line with all
three fields.
In 'normal' mode, your printer must be capable of 80 columns,
and in 'condense' mode, 132 columns.
Editing
To edit a particular record, just double click on a record. If the
record is already highlighted, then just click once on it. You may edit
the record or cancel. Any record you click on will stay highlighted until
the next find/edit or sort operation. You may also delete a file by
clicking once on a record and then selecting delete name on the menu. To
unselect a record which is highlighted, move the mouse pointer down
either below the last record (if the page isn't full), or as far down
the screen as it will go and click once.
Whenever you perform any edit/insert or a find operation with wild
cards, the catalog may not be in sort order anymore. What you see on
the display is the order they are stored on the catalog. So you may
want/need to choose sort again before saving the file.
Disk.cat is provided as an example catalog.
ADDITIONS:
Note for those who have purchased previous versions of HyperCat
(ie. V1.1 or V1.11), there is a utility accessible only from the CLI
called HyperConvert. Use this program to convert catalogs created by
V1.1 or V1.11 HyperCat into the faster loading format of V1.20 and V1.30.
Note that it may run quite slow, so don't think that it's gone to lunch!
Usage from CLI is as follows:
HyperConvert <oldfile> <newfile>
where oldfile is your old catalog, and newfile is the new format.
Please direct criticisms/comments/donations/praise etc to:
HyperCat
P.O. BOX 231
Burwood
3125
Upgrades or requests to customize a cataloger will be answered only
if accompanied by MONEY! ($20 or more preferably). Upgrades will cost
about $5 - $10 depending on whether its a program bug or a real upgrade.
(Send a blank disk too, if upgrading).